home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / language / embedded / 68hc11 / macasm1p.txt < prev    next >
Text File  |  1994-10-20  |  7KB  |  162 lines
  1.  
  2.                             RELEASE NOTES
  3.  
  4.                Motorola Freeware Assemblers for the Macintosh
  5.                              "Version 1.2"
  6.  
  7.  
  8. INTRODUCTION
  9.  
  10. Version 1.2 of the Motorola Freeware Assemblers was recently released 
  11. and posted on the Motorola Freeware BBS.  Source code and executable 
  12. files were provided for the IBM PC and clones.  I have completed a port 
  13. to the Macintosh using the source code available to allow Macintosh 
  14. users access to the improvements of Bruce Olney and Greg Thoman.
  15.  
  16. The entire set of Macintosh XASMs are available in PACKIT form under the 
  17. file name macasm1p2.pit.  Individual files are available as macXX_1p2 
  18. where XX represents the device type 00, 01, 04, 05, 09, or 11.
  19.  
  20.  
  21. QUICK AND DIRTY
  22.  
  23. I have tried to make as few changes and additions to the original source 
  24. code as possible for the following reasons:
  25.  
  26.      1. To maintain the integrity of the final product (assembled code).
  27.      2. To keep the turn around time as short as possible.
  28.      3. To allow future enhancements and/or fixes to the IBM assemblers
  29.         to be applied easily and quickly.
  30.  
  31. The drawback of this approach, however, is that these are not true 
  32. "Macintosh" applications.  Pull-down menus, dialog boxes, etc. are not 
  33. supported.  Once you double-click to launch the application it's back to 
  34. command line entry.  Fortunately, there is not much to do besides enter 
  35. filenames and output options.  (see Motorola Freeware Assembler User's 
  36. Manual Chapter 3 - Running the Assembler).  The user may also redirect 
  37. the output to a file or printer   Once the assembly is done the program 
  38. quits and your back to the Finder.
  39.  
  40.  
  41. FILE STRUCTURE
  42.  
  43. The new version of the assembler does support the Hierarchical File 
  44. Structure (HFS) of the Macintosh.  However, because the program is not 
  45. really "mac-like" you will want to keep things simple or be prepared to 
  46. do a lot of typing.  The following information should be noted:
  47.  
  48.      1. The assembler may be located in any folder of an HFS volume 
  49.         (HD or floppy).  It does not have to reside in the root of
  50.         the volume.
  51.  
  52.      2. The directory (folder) in which the application is launched
  53.         becomes the default or working directory.  (NOTE: The default
  54.         is changed if another directory is selected when redirecting
  55.         output to a file or printer - this can be tricky).
  56.  
  57.      3. Files may be specified by either partial or full pathnames as
  58.         explained below.
  59.  
  60.      4. When assembling multiple source files the pathname for each file
  61.         must be completely specified.
  62.  
  63.      5. Due to the method used by the assembler to parse the command
  64.         line input the pathname cannot contain spaces which are
  65.         normally allowed in Macintosh folder and file names.
  66.  
  67.  
  68. PATHNAMES
  69.  
  70. A pathname on the Macintosh is a concatenation of volume names, 
  71. directory names, and file names separated by colons.
  72.  
  73. Assume you organize your files as shown below (indentations indicate 
  74. levels of hierarchy):
  75.  
  76.   BigHD (root name of your hard disk)
  77.     Development (a folder on the root)
  78.       Hardware (a folder in Development)
  79.       Firmware (a folder in Development)
  80.         - Doit (an assembler source file)
  81.         - Stopit (an second assembler source file)
  82.  
  83. A full pathname always begins with the name of the root directory; it 
  84. names the path from the root to a given file or directory, and includes 
  85. each of the directories visited on that path. For example, a full 
  86. pathname to the source file Doit would be:
  87.  
  88.   BigHD:Development:Firmware:Doit
  89.  
  90. Thus, a full pathname may be used to specify a file anywhere on any 
  91. mounted volume.
  92.  
  93. A partial pathname describes the path to a file starting from the 
  94. working directory.  Partial pathnames must begin with a colon, except in 
  95. the case where the partial pathname contains only one name.  Thus, if 
  96. the assembler was located in the directory Development (and redirection 
  97. of output did not change the working directory), the partial pathname to 
  98. the file Doit would be:
  99.  
  100.   :Firmware:Doit
  101.  
  102. If the assembler was located in the directory Firmware with the source 
  103. files, the partial pathname to the file Doit would be just:
  104.  
  105.   Doit
  106.  
  107. This is the best way to organize things if you don't like to type long 
  108. pathnames.  Just throw everything in the same directory (folder).
  109.  
  110. It is also possible to move up the directory tree by using consecutive 
  111. colons (::). This notation indicates that the name following a double 
  112. colon is an offspring of the current location╒s parent, rather than an 
  113. offspring of the directory preceding the double colon.
  114.  
  115. Thus, if you launch the assembler in the Firmware directory and want to 
  116. assemble a file in the Hardware directory named HW_Test the partial path 
  117. would be:
  118.  
  119.   ::Hardware:HW_Test
  120.  
  121.  
  122. IMPLEMENTATION
  123.  
  124. The Macintosh version of the assemblers were compiled using THINK C 4.0.  
  125. The THINK compiler provides a set of library routines called the console 
  126. that make it easy to run code written machines like the IBM PC, VAX etc. 
  127. that use stdio routines for input and output.  These routines set up a 
  128. window on the Macintosh that acts like a TTY terminal.  They also 
  129. provide a mechanism for simulating the command line invocation used by 
  130. operating systems like DOS, VMS.  The only changes made to the original 
  131. source code (other than the addition of the console initialization 
  132. routines) were to add the appropriate header files and some explicit 
  133. pointer type casting to satisfy the compiler.
  134.  
  135.  
  136. TESTING
  137.  
  138. Unfortunately, my library of good source code is small and as a result 
  139. very limited testing has been done on these assemblers.  For the 6805 
  140. assembler I have compared S record files for some simple files to those 
  141. produced by the original Macintosh assemblers and found no errors.  The 
  142. other assemblers have not been tested except to double-click them and 
  143. see if they go.  I am relying on those who have gone before to provide 
  144. good code and the user community to catch the bugs.  If you find bugs 
  145. please report these to the Motorola Freeware BBS so that both the 
  146. Macintosh and the IBM PC versions can be updated in step.
  147.  
  148.  
  149. ADDITIONAL INFORMATION
  150.  
  151. This is the only additional documentation provided for Macintosh version 
  152. of the Motorola Freeware Assemblers v1.2.  I refer the user to the 
  153. asrefnew.man file in the IBM directory of the Motorola BBS for further 
  154. information about the assemblers.  Also check the README.TXT, and 
  155. ASSEMBLER.DOC files included in the fasrc1p2.arc archive file in the IBM 
  156. directory for information pertaining to the v1.2 release.
  157.  
  158.  
  159. Robert Barnes
  160. 14 August 1990
  161.